2020.1

Release Notes

On this page:

2020.1.2 Maintenance Release

2020.1.2 Maintenance Release [2020-07-07]

Changelog Overview

  • 3 New Features
  • 21 Improvements
  • 46 Bug Fixes
  • 1 Security Fixes
  • 8 Chores
  • 1 Deprecations
  • 80 Total Tickets

New Features

  • adapter-local_aaa:3.0.6-2020.1.1 [07-01-2020] - Workflow tasks added that allow for user administration.
  • pronghorn-core:10.19.4-2020.1.17 [06-29-2020] - Integrated the RabbitMQ event de-duplication feature.
  • pronghorn-core:10.19.4-2020.1.16 [06-29-2020] - Created a new method to handle restarting an active module on the system.

Improvements

  • adapter-email:3.1.10-2020.1.2 [06-18-2020] - Added the mailWithOptions task. With this new task, users can specify one or more recipients in the cc and bcc fields, and attach one or more text files to send via email.
  • adapter-nso:6.29.3-2020.1.13 [07-02-2020] - Adapter info added to the "couldn't connect to NSO" log message.
  • adapter-nso:6.29.3-2020.1.8 [06-12-2020] - Added example inputs and corrected API documentation for addDevice task.
  • adapter-nso:6.29.3-2020.1.6 [06-01-2020] - Updated path when getting version info to match new package name.
  • app-automation_catalog:2.6.6-2020.1.7 [06-05-2020] - Updated agenda library to version 3.
  • app-automation_studio:2.0.14-2020.1.4 [06-04-2020] - Correct error message now displays when textfsm dependency is missing.
  • app-mop:6.3.24-2020.1.6 [06-26-2020] - Analytic and Command Templates now return referenced tags.
  • app-nso_manager:2.20.1-2020.1.4 [06-03-2020] - Added test coverage for NSO manager.
  • app-smart_template:1.9.4-2020.1.1 [06-03-2020] - Added test coverage for API endpoints.
  • app-workflow_builder:5.10.4-2020.1.13 [06-26-2020] - Added ability to export workflow on edit workflow screen.
  • app-workflow_builder:5.10.4-2020.1.12 [06-26-2020] - Enabled name referencing in transformation task.
  • app-workflow_engine:7.14.4-2020.1.28 [06-26-2020] - An error will now return if the requested JST does not exist when running a workflow that uses a transformation.
  • app-workflow_engine:7.14.4-2020.1.25 [06-16-2020] - Updated JST package to v3.0.0.
  • app-workflow_engine:7.14.4-2020.1.24 [06-09-2020] - Improved workflow validation by adding loop self-containment and invalidating transition schemes that break prior workflows.
  • app-workflow_engine:7.14.4-2020.1.22 [06-05-2020] - EventListenerJob tasks no longer error on workflow engine restart and continue to run.
  • itential-utils:2.2.22 [06-09-2020] - Cleaned up decoding and encryption logic for discovery.
  • itential_tools:1.23.18.2020.1.5 [06-09-2020] - Package filename now has hyphens rather than underscores. This will align the package name with the Cisco NSO documentation.
  • itential_tools:1.23.18-2020.1.2 [06-02-2020] - Updated Itential Tools name in package metadata to conform to standards.
  • pronghorn-core:10.19.4-2020.1.21 [07-01-2020] - Made improvements to existing functionality to better protect the core logic of IAP.
  • pronghorn-core:10.19.4-2020.1.19 [06-30-2020] - Removed RabbitMQ property from service config schema. Automatically migrated all service configs to remove RabbitMQ configuration.
  • pronghorn-core:10.19.4-2020.1.14 [06-25-2020] - Enabled name search of JSON Transformations.

Bug Fixes

  • adapter-nso:6.29.3-2020.1.12 [07-01-2020] - Standardized rpc error log format.
  • adapter-nso:6.29.3-2020.1.11 [07-01-2020] - Fixed live-status error log.
  • adapter-nso:6.29.3-2020.1.10 [06-26-2020] - Fixed NSO netconf XML message via parsing and replacing illegal chars.
  • adapter-nso:6.29.3-2020.1.9 [06-26-2020] - Changed xpath query to obtain device groups from NSO.
  • adapter-nso:6.29.3-2020.1.7 [06-01-2020] - Error message is returned when required params are not provided.
  • app-admin_essentials:1.0.0-2020.1.9 [06-03-2020] - Implemented fix to prevent artifact sorting from being case sensitive and to provide better numeric ordering for artifact names.
  • app-automation_studio:2.0.14-2020.1.7 [06-26-2020] - Users are now able to filter items by tags.
  • app-automation_studio:2.0.14-2020.1.6 [06-12-2020] - Updated PHLoader properties to correctly load.
  • app-automation_studio:2.0.14-2020.1.5 [06-12-2020] - Changed the workflows collection route from /workflows to /automations.
  • app-configuration_manager:3.43.14-2020.1.18 [06-29-2020] - Improved the accuracy of device availability in the device picker for Golden Configuration.
  • app-configuration_manager:3.43.14-2020.1.17 [06-26-2020] - Improved config viewer to properly format configurations.
  • app-configuration_manager:3.43.14-2020.1.16 [06-24-2020] - Implemented banner support for IOS-XR devices.
  • app-configuration_manager:3.43.14-2020.1.15 [06-21-2020] - Added support for multi-line quotes for F5 device configurations.
  • app-configuration_manager:3.43.14-2020.1.14 [06-08-2020] - Fixed the issue with compliance reports breaking indefinitely.
  • app-form_builder:4.2.23-2020.1.5 [06-29-2020] - Service models in Forms are visible in the search bar.
  • app-form_builder:4.2.23-2020.1.4 [06-26-2020] - Form tables now correctly assign keys in the output data.
  • app-form_builder:4.2.23-2020.1.3 [06-12-2020] - Create button added to collection tabs in the side navbar.
  • app-form_builder:4.2.23-2020.1.2 [06-08-2020] - Fixed key integrity logic for nested tables.
  • app-golden_config:5.18.3-2020.1.3 [07-02-2020] - Modified seed script so it does not insert workflow if the same one already exists.
  • app-json_forms:1.14.10-2020.1.8 [06-22-2020] - Updated table component to allow drag and drop for nested tables and containers.
  • app-json_forms:1.14.10-2020.1.7 [06-08-2020] - Mongo keys are encoded for dynamic data binding and dynamic validation payloads.
  • app-json_forms:1.14.10-2020.1.6 [06-08-2020] - Default placeholders added to input fields.
  • app-mop:6.3.24-2020.1.5 [06-12-2020] - Added create buttons for collection tabs in the side navbar.
  • app-mop:6.3.24-2020.1.4 [06-13-2020] - Fixed the issue where a case of a failed command on a device does not produce results.
  • app-smart_template:1.9.4-2020.1.3 [07-02-2020] - Fixed dryrun response parsing error for MultiDryrunWF task.
  • app-smart_template:1.9.4-2020.1.2 [06-08-2020] - Fixed bug where enclosing DryRunWF or ProvisionWF instance data in an array would crash Smart Template.
  • app-template_builder:2.4.4-2020.1.2 [06-03-2020] - ParseTemplate method is now handling errors more precisely by checking if response object from getPythonResults contains an error property.
  • app-workflow_builder:5.10.4-2020.1.11 [06-17-2020] - Removed excessive call to Tags API.
  • app-workflow_builder:5.10.4-2020.1.10 [06-12-2020] - Sidenav updated to show create buttons for each tab.
  • app-workflow_engine:7.14.4-2020.1.30 [06-30-2020] - Fixed bug where deactivated task workers would drop messages instead of allowing other workers to pick up the task.
  • app-workflow_engine:7.14.4-2020.1.27 [06-25-2020] - Added an error notification on the Job Manager page when collections aren't correctly indexed.
  • app-workflow_engine:7.14.4-2020.1.26 [06-24-2020] - Fixed a bug to correctly revert the parent job to the childJob task if the childJob is reverted.
  • app-workflow_engine:7.14.4-2020.1.23 [06-08-2020] - Added graceful error handling for scenarios where metrics are being ran on workflows that do not have valid user context information available.
  • automation-gateway:2.74.12-2020.1.14 [06-30-2020] - Made updates to POC licensing system.
  • automation-gateway:2.74.12-2020.1.13 [07-03-2020] - Card collection dialogue now scales appropriately for smaller screens.
  • automation-gateway:2.74.12-2020.1.12 [06-24-2020] - Added property to enable/disable IPv6 support.
  • itential-utils:2.2.23 [06-10-2020] - Exposed FileCrypto for use in the itential-utils module
  • itential_tools:1.23.18.2020.1.6 [07-06-2020] - Corrected the version of itential_tools.
  • itential_tools:1.23.18.2020.1.4 [07-01-2020] - Updated README and project files to reflect project rename.
  • itential_tools:1.23.18-2020.1.3 [06-03-2020] - Corrected STAROS show config command.
  • pronghorn-core:10.19.4-2020.1.18 [06-30-2020] - Fixed error where $refs would not be correctly resolved when using query parameters.
  • pronghorn-core:10.19.4-2020.1.15 [07-03-2020] - Fixed Session Manager to prevent IAP crash due to lack of a Redis connection; also fixed error events in ioredis to be handled better in service library.
  • pronghorn-core:10.19.4-2020.1.12 [06-15-2020] - Changed the minimum required MongoDB version from 3.4 to 3.6.
  • pronghorn-core:10.19.4-2020.1.11 [06-15-2020] - Removed bug that caused a Core failure if functionality was invoked.
  • pronghorn-core:10.19.4-2020.1.10 [06-05-2020] - Fixed a crash caused by an undefined user when resolving a response that was already sent.
  • pronghorn-core:10.19.4-2020.1.9 [06-03-2020] - Fixed key management logic for nested tables.

Security Fixes

  • adapter-prospector:1.6.16-2020.1.2 [07-01-2020] - Refactored the adapter to use the 'itential/database' module for uniformity, security, and better maintainability.

Chores

  • app-configuration_manager:3.43.14-2020.1.13 [06-04-2020] - Added API test coverage.
  • app-golden_config:5.18.3-2020.1.2 [07-02-2020] - Removed unnecessary peer dependencies.
  • app-golden_services:1.5.2-2020.1.1 [07-02-2020] - Removed peer dependencies.
  • app-service_catalog:3.10.4-2020.1.3 [06-22-2020] - Removed an unused dependency on app-service_management.
  • app-workflow_engine:7.14.4-2020.1.29 [06-29-2020] - Updated jst dependency to 3.1.0.
  • itential-utils:2.2.24 [06-15-2020] - Updated node driver for MongoDB.
  • pronghorn-core:10.19.4-2020.1.20 [06-30-2020] - Disabled deduplication related log messages when deduplication is not configured and enhanced service module to handle uncaught exceptions from the database connection during start up.
  • pronghorn-core:10.19.4-2020.1.13 [06-23-2020] - Updated node driver for MongoDB.

Deprecations

  • adapter-email:3.1.10-2020.1.1 [06-05-2020] - Added deprecation notice for 'mail' task to be replaced by 'mailWithOptions' task.

2020.1.2 Release Versions

Automation Platform Versions

component version
@itential/adapter-automation_gateway 4.0.0-2020.1.2
@itential/adapter-azure_aaa 1.1.2-2020.1.0
@itential/adapter-email 3.1.10-2020.1.2
@itential/adapter-ldap 2.12.10-2020.1.0
@itential/adapter-local_aaa 3.0.6-2020.1.1
@itential/adapter-mongo 2.9.4-2020.1.0
@itential/adapter-nso 6.29.3-2020.1.13
@itential/adapter-policy_engine 1.0.11-2020.1.0
@itential/adapter-prospector 1.6.16-2020.1.2
@itential/adapter-radius 2.0.6-2020.1.0
@itential/adapter-redis 2.0.10-2020.1.0
@itential/app-admin_essentials 1.0.0-2020.1.9
@itential/app-ag_manager 1.1.1-2020.1.1
@itential/app-automation_catalog 2.6.6-2020.1.7
@itential/app-automation_studio 2.0.14-2020.1.7
@itential/app-configuration_manager 3.43.14-2020.1.18
@itential/app-form_builder 4.2.23-2020.1.5
@itential/app-golden_config 5.18.3-2020.1.3
@itential/app-golden_services 1.5.2-2020.1.1
@itential/app-json_forms 1.14.10-2020.1.8
@itential/app-mop 6.3.24-2020.1.6
@itential/app-nso_manager 2.20.1-2020.1.4
@itential/app-policy_manager 3.44.1-2020.1.6
@itential/app-service_catalog 3.10.4-2020.1.3
@itential/app-service_management 2.23.7-2020.1.2
@itential/app-smart_template 1.9.4-2020.1.3
@itential/app-task_worker 3.1.4-2020.1.0
@itential/app-template_builder 2.4.4-2020.1.2
@itential/app-workflow_builder 5.10.4-2020.1.13
@itential/app-workflow_engine 7.14.4-2020.1.30
@itential/pronghorn-core 10.19.4-2020.1.21
@itential/search 1.1.6-2020.1.0
@itential/tags 2.2.12-2020.1.0
@itential/itential-utils 2.2.24

Automation Gateway Versions

component version
automation_gateway 2.74.12-2020.1.14

NSO Manager Versions

component version
itential-tools 1.23.18.2020.1.6
prospector 1.10.4-2020.1.1

Engine Versions

component version
policy-engine 1.10.4-2020.1.0

Dependencies

Automation Platform Server

package supported versions recommended version
nodejs 12.x 12.18.0

The gcc-c++ and make packages should be installed from your OS distribution.

Template Builder

package supported recommended
python 2.x or 3.x 3.8.3
pip supported recommended
pip any version 20.1.1
textfsm 1.x 1.1.0
Jinja2 2.x 2.11.2

Mongo Server

package supported recommended
mongodb 3.6.x 3.6.17

RabbitMQ Server

package supported recommended
rabbitmq 3.8.x 3.8.5
erlang 21.3+ or 22.x 22.3

RabbitMQ Plugins

Download: https://github.com/noxdafox/rabbitmq-message-deduplication/releases

package supported recommended
elixir release 0.4.X - 1.8.x release 0.4.5 - 1.8.2
rabbitmq_message_deduplication release 0.4.X - v3.8.x release 0.4.5 - v3.8.x

Redis Server

package supported recommended
redis 5.x 5.0.9

The gcc-c++ and make packages should be installed from your OS distribution.

Automation Gateway

package supported recommended
python 3.6 3.6.10
openssl 1.x 1.1.1g
haproxy 2.x 2.1.3

The gcc-c++ and make packages should be installed from your OS distribution.

The following development packages are required to install automation gateway: libffi-dev, openssl-dev, python-dev, sqlite-dev.

pip package supported recommended
pip any version 20.1.1
ansible 2.7, 2.8 or 2.9 2.9.9

One or more of the following packages may be required by the specific ansible modules you're using: psutil, pycrypto, paramiko, ncclient, lxml, nitrosdk-python, jxmlease.

Check the ansible documentation for the roles you're planning to use for additional package requirements.

Prospector

package supported recommended
java 1.7 or 1.8 1.8.242.08

NSO/Itential Tools

package supported recommended
java 1.7 or 1.8 1.8.242.08

The ant package should be installed from your OS distribution.

IAP Compatibility

Device Configuration

Device Configuration compatibility describes which devices are expected to work with the basic features of the Configuration Manager application across various southbound systems.

Ansible: 

* Arista EOS
* Cisco IOS
* Cisco IOSXR
* Cisco NX
* Juniper Junos

NSO:

Refer to the NSO Versions and NED Versions tables below for a list of tested devices.

Device Compliance

Device Compliance compatibility describes which devices are expected to work with Golden Configurations.

Ansible: 

* Arista EOS
* Cisco IOS
* Cisco IOSXR
* Cisco NX
* Juniper Junos

NSO (Configuration Manager app): 

* Arista EOS
* Cisco IOS
* Cisco IOSXR
* Cisco NX
* Juniper Junos

NSO (Golden Config app): 

* a10-acos
* adtran-aos
* alu-sr
* arista-dcs
* cisco-ios
* cisco-iosxr
* cisco-nx
* cisco-staros
* f5-bigip
* huawei-vrp
* juniper-junos

Device Maintenance

Device Maintenance compatibility describes which devices Itential can perform maintenance activities on (e.g., reboots and firmware upgrades).

Ansible: 

* Arista EOS
* Cisco IOS
* Cisco IOSXR
* Juniper Junos

NSO: 

* cisco-ios
* cisco-iosxr
* juniper-junos

Device Health Checks

Device Health Checks compatibility describes which devices Itential can execute read-only show commands to use the method broker and Command Templates application.

Ansible: 

* Arista EOS
* Cisco IOS
* Cisco IOSXR
* Cisco NX
* Juniper Junos

NSO: 

* a10-acos
* alu-sr
* arista-dcs
* cienacli-acos
* cisco-aireos
* cisco-asa
* cisco-gss
* cisco-ios
* cisco-iosxr
* cisco-nx
* cisco-qps
* cisco-staros
* ericsson-sgsnmme
* f5-bigip
* huawei-vrp
* juniper-junos

Note: Some of the devices in the health checks category are tested against netsim devices.

Forms

Ansible:

IAP can render most ansible networking modules as forms. Support for specific modules may vary. If you encounter issues with any particular modules, reach out to the Itential Product Support Team for assistance.

NSO:

IAP can render most service models advertised by NSO as forms. Support for specific yang features may vary. If you encounter issues with your service models, reach out to the Itential Product Support Team for assistance.

Service Provisioning

NSO:

IAP can provision most service models advertised by NSO. Support for specific yang features may vary. If you encounter issues with your service models, reach out to the Itential Product Support Team for assistance.

Devices/Services Compatibility

The Itential Automation Platform is tested against the following component versions.

Ansible Versions:

* 2.7.18
* 2.8.12
* 2.9.9

Ansible Modules:

* eos_facts
* eos_command
* eos_config
* ios_facts
* ios_command
* ios_config
* iosxr_facts
* iosxr_command
* iosxr_config
* nx_facts
* nx_command
* nx_config
* junos_facts
* junos_command
* junos_config

NSO Versions:

* 5.3.1.1
* 5.2.2.1
* 4.7.7
* 4.6.5

NSO NED Versions:

ned 4.6.5 4.7.7 5.2.2.1 5.3.1.1
a10-acos 3.15.3 3.16.1 3.16.1
3.16		 3.16.1
adtran-aos 4.0.5 4.0.5 4.0.5 4.0.5
alu-sr 8.3 8.6.1 8.6.1
8.6		 8.6.1
8.6
arista-dcs 5.7 5.10.2 5.10.2
5.10.1		 5.10.2
5.10.1
checkpoint-gaiaos_rest 1.3.8 1.3.10 1.8.8
1.8.7		 1.8.8
1.8.7
ciena-acos 6.1.5 6.1.5 6.1.5 6.1.5
cisco-aireos 3.3.20 3.3.18 3.3.20 n/a
cisco-asa 6.7.7 6.8.7 6.8.7
6.8.6		 6.8.7
6.8.6
cisco-gss 2.1.1 2.1.1 2.1.1 2.1.1
cisco-ios 6.42.2 6.48 6.48
6.47		 6.48
6.47
cisco-iosxr 7.18.2 7.23.1 7.23.1
7.23		 7.23.1
7.23
cisco-nx 5.1.3 5.15.5 5.15.5
5.15.4		 5.15.5
5.15.4
cisco-qps 5.1.2 5.1.0 5.1.3
5.1.2		 5.1.3
cisco-staros 5.22.1 5.24.1 5.24.1
5.24		 5.24.1
5.24
ericsson-sgsnmme 1.0.7 1.0.7 1.0.7 1.0.7
f5-bigip 3.7.13 3.9.3 3.9.3
3.9.2		 3.9.3
3.9.2
fortinet-fortios 5.4 5.4.5 5.4.5
5.4.4		 5.4.5
5.4.4
huawei-usn 1.2.1 1.2.1 1.2.1 1.2.1
huawei-vrp 6.1 6.3.9 6.3.9
6.3.8		 6.3.9
6.3.8
juniper-junos 4.5.17 4.5.23 4.5.23
4.5.22		 4.5.23
4.5.22
paloalto-panos_cli 4.3.1 4.0.1 4.3.5
4.3.4		 4.3.5
radware-alteonos 2.4 2.4 2.4 n/a
unix-bind 2.0.17 2.1.0 2.1.0
2.0.17		 2.1.0

VTS Versions:

* 2.6.2

VTS NED Versions:

ned 2.6.2
cisco-iosxr 6.6
cisco-ncs5500 1.0
cisco-nx 5.1.4

Virtual Devices:

* A10 vThunder 4.1.4 GR1
* Arista EOS-4.23.0FX
* Checkpoint R80.30-273.583
* Cisco ASAv 9.13.1.7
* Cisco CSR 16.12.1a
* Cisco NX 9.3.2, 9.3.1
* Cisco StarOS 21.15.29
* Cisco XR6.3.1
* F5 BIGIP 15.1.0.2-0.0.9
* Fortigate 6.4.0
* Juniper VMX 18.4R1
* Juniper VSRX 19.1R2
* PanOS 9.1.2
* Radware 32.6.0.0

IAP Browser Compatibility

This maintenance release was tested against the following browser versions:

* Firefox 69.0
* Chrome 76.3809.87
* Edge 44.18362.1.0
* IE11 11.678.17763